Deprecate gtk_icon_theme_add_builtin_icon

Builtin icons are deprecated in favor of loading icons
from resource paths.

diff --git a/gtk/gtkicontheme.c b/gtk/gtkicontheme.c
index f715af8acb51d76fccc2363d3e0a1da7509a790e..8ecfa90fc972f4cfdeb418421e9a3136d7ca8343 100644 (file)
--- a/gtk/gtkicontheme.c
+++ b/gtk/gtkicontheme.c
@@ -3585,6 +3585,9 @@ gtk_icon_info_get_filename (GtkIconInfo *icon_info)
  *     The returned image must not be modified.
  *
  * Since: 2.4
+ *
+ * Deprecated: 3.14: This function is deprecated, use
+ *     gtk_icon_theme_add_resource_path() instead of builtin icons.
  */
 GdkPixbuf *
 gtk_icon_info_get_builtin_pixbuf (GtkIconInfo *icon_info)
@@ -5000,6 +5003,9 @@ gtk_icon_info_get_display_name (GtkIconInfo *icon_info)
  * via gdk_pixbuf_new_from_inline().
  *
  * Since: 2.4
+ *
+ * Deprecated: 3.14: Use gtk_icon_theme_add_resource_path()
+ *     to add application-specific icons to the icon theme.
  */
 void
 gtk_icon_theme_add_builtin_icon (const gchar *icon_name,

diff --git a/gtk/gtkicontheme.h b/gtk/gtkicontheme.h
index e37a52dd9d6335876cb680b52f8f5d937cf97213..e57c95c3dd19d07dc4c758cc4e0af8f163e3d12f 100644 (file)
--- a/gtk/gtkicontheme.h
+++ b/gtk/gtkicontheme.h
@@ -270,7 +270,7 @@ char *        gtk_icon_theme_get_example_icon_name (GtkIconTheme
 GDK_AVAILABLE_IN_ALL
 gboolean      gtk_icon_theme_rescan_if_needed      (GtkIconTheme                *icon_theme);
 
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_14_FOR(gtk_icon_theme_add_resource_path)
 void          gtk_icon_theme_add_builtin_icon      (const gchar *icon_name,
                                                    gint         size,
                                                    GdkPixbuf   *pixbuf);
@@ -292,7 +292,7 @@ GDK_AVAILABLE_IN_3_10
 gint                  gtk_icon_info_get_base_scale     (GtkIconInfo   *icon_info);
 GDK_AVAILABLE_IN_ALL
 const gchar *         gtk_icon_info_get_filename       (GtkIconInfo   *icon_info);
-GDK_AVAILABLE_IN_ALL
+GDK_DEPRECATED_IN_3_14
 GdkPixbuf *           gtk_icon_info_get_builtin_pixbuf (GtkIconInfo   *icon_info);
 GDK_AVAILABLE_IN_3_12
 gboolean              gtk_icon_info_is_symbolic        (GtkIconInfo   *icon_info);